README, AGENTS, the architecture rule, the linter, and the
generate-strata-docs skill pointed at a docs/superpowers/ design
spec and its section numbers (§3.3, §3.3b, §3.6, §8). That spec was
never committed; the running pipeline and skills are the source of
truth, so remove the references instead of resurrecting it.
README also claimed the doc-generation Action runs "weekly, or on
sources.md change". Both doc actions are workflow_dispatch only, so
they run manually; AGENTS already described this correctly.
Closes #2
What
Removes references to a
docs/superpowers/design spec that was never committed, and corrects README's description of when the doc-generation Actions run. The pipeline and skills are themselves the source of truth now, so the historical spec does not need to live in the repo.Closes #2
How
Dropped all six sites that pointed at the spec: the
docs/superpowers/links inREADME.md,AGENTS.md, andrules/architecture.md, and the§-section annotations (§3.3,§3.3b,§3.6,§8) inscripts/lint_docs.py,skills/generate-strata-docs/SKILL.md, andskills/generate-strata-docs/references/agents/source-doc.md. Load-bearing phrasing next to an annotation (e.g. "no fallback" beside§8) was preserved. Also changed README's "manual, weekly, or onsources.mdchange" to "manual", matching theworkflow_dispatch-only triggers and AGENTS.Test plan
python -m scripts.lint_manifest→ MANIFEST_OK (9 sources)python -m scripts.lint_docs→ DOCS_OK (56 docs)python -m scripts.build_graph→ GRAPH_OK; no change todocs/INDEX.mdordocs/graph.jsonpython -m pytest -q→ 53 passedgrepconfirms nodocs/superpowersor spec§references remainNotes for reviewers
Docs, skill instructions, and code comments only; no build or runtime impact. The FMLA legal citations (
§ 2612,§ 825) indocs/sources/anddocs/.verification/are unrelated to the design spec and were left in place.